|
Server : LiteSpeed System : Linux host 5.15.0-161-generic #171-Ubuntu SMP Sat Oct 11 08:17:01 UTC 2025 x86_64 User : idnco5810 ( 1093) PHP Version : 8.2.29 Disable Function : NONE Directory : /lib/python3/dist-packages/cloudinit/sources/__pycache__/ |
Upload File : |
o
쑛h�P � @ s" d Z ddlZddlZddlZddlZddlZddlmZmZm Z m
Z
m Z m Z ddl
mZmZmZmZmZ ddlmZ ddlmZmZmZmZ ddlmZ e� e �Z dd iZ d
Z d Z!d Z"e!d
Z#e"d
Z$ddiZ%dZ&G dd� de
�Z'G dd� dej(�Z)deddfdd�Z*G dd� dej+�Z,G dd � d e,�Z-d e.fd d �Z/de e. fd d!�Z0de1fd"d#�Z2d$e.de3fd%d&�Z4d$e.de ee.e.f fd'd(�Z5d$e.de.fd)d*�Z6d e,j7e,j8e#gd+�d,e1d-e e. de e' fd.d/�Z9e,ej:ffe-ej:ej;ffgZ<d0d1� Z=e d2k�rd3Z>e?e�@e9e$e#gd4�e2� d5��� dS dS )6a3 Datasource for Oracle (OCI/Oracle Cloud Infrastructure)
Notes:
* This datasource does not support OCI Classic. OCI Classic provides an EC2
lookalike metadata service.
* The UUID provided in DMI data is not the same as the meta-data provided
instance-id, but has an equivalent lifespan.
* We do need to support upgrade from an instance that cloud-init
identified as OpenStack.
* Bare metal instances use iSCSI root, virtual machine instances do not.
* Both bare metal and virtual machine instances provide a chassis-asset-tag of
OracleCloud.com.
� N)�Any�Dict�List�
NamedTuple�Optional�Tuple)�
atomic_helper�dmi�net�sources�util)�
NetworkConfig)�cmdline� ephemeral�get_interfaces_by_mac�is_netfail_master)� wait_for_url�configure_secondary_nicsFzOracleCloud.comz&http://169.254.169.254/opc/v{version}/z+http://[fd00:c1::a9fe:a9fe]/opc/v{version}/z{path}/�
Authorizationz
Bearer Oraclei(# c @ sB e Zd ZU eed< eeef ed< eeeef ed< eed< dS )�ReadOpcMetadataResponse�version�
instance_data�
vnics_data�
imds_url_usedN) �__name__�
__module__� __qualname__�int�__annotations__r �strr r � r r �D/usr/lib/python3/dist-packages/cloudinit/sources/DataSourceOracle.pyr 4 s
r c @ s e Zd ZdZdefdd�ZdS )� KlibcOracleNetworkConfigSourcez�Override super class to lower the applicability conditions.
If any `/run/net-*.cfg` files exist, then it is applicable. Even if
`/run/initramfs/open-iscsi.interface` does not exist.
�returnc C s
t | j�S )zOverride is_applicable)�bool�_files��selfr r r! �
is_applicableB �
z,KlibcOracleNetworkConfigSource.is_applicableN)r r r �__doc__r$ r( r r r r! r" ; s r" �network_configr# c C s d| vrdS | d dvrt �d| d � dS t� }| d dkrJdd� | d D �D ] }|d d
krGd |v rG|d }|�|�}|s@q(t|�rG|d = q(dS | d d kr�| �d
i ��� D ]/\}}d|v r�|�di ��d�}|r�|�|�}|ssqXt|�r�|d d= |d= ||d d< qXdS dS )aP
Search network config physical interfaces to see if any of them are
a netfailover master. If found, we prevent matching by MAC as the other
failover devices have the same MAC but need to be ignored.
Note: we rely on cloudinit.net changes which prevent netfailover devices
from being present in the provided network config. For more details about
netfailover devices, refer to cloudinit.net module.
:param network_config
A v1 or v2 network config dict with the primary NIC, and possibly
secondary nic configured. This dict will be mutated.
r N)� � z+Ignoring unknown network config version: %sr, c S s g | ]}d |v r|�qS )�typer )�.0�cr r r! �
<listcomp>c s z,_ensure_netfailover_safe.<locals>.<listcomp>�configr. �physical� mac_addressr- � ethernets�match�
macaddresszset-name�name)�LOG�debugr �getr �items)r+ � mac_to_name�cfg�mac�cur_name�_�macaddrr r r! �_ensure_netfailover_safeG sH �
��
��rC c s� e Zd ZU dZdZejjejjejj ejj
fZ e ejdf e
d< dZdZdZ� fdd �Zd
ed df� fd d
� Zd efdd�Zed efdd��Zdd� Zd efdd�Zdd� Zd efdd�Zd e fdd�Z e d d � �Z d"d efd d!�Z � Z!S )#�DataSourceOracle�OracleN.�network_config_sourcesT� � c st t t| �j|g|�R i |�� d | _t�t�|d| jgi �tg�| _ t
� | _ g dd�| _ | �
� }|j| _|j| _d S )N�
datasourcer, �r2 r )�superrD �__init__� _vnics_datar �
mergemanydict�get_cfg_by_path�dsname�BUILTIN_DS_CONFIG�ds_cfgr" �_network_config_source�_network_config�get_url_params�max_wait_seconds� url_max_wait�timeout_seconds� url_timeout)r' �sys_cfg�args�kwargs�
url_params�� __class__r r! rL � s �� zDataSourceOracle.__init__�ci_pkl_versionr# c sX t � �|� t| d�st| dd � t| d�s t| dt� � t| d�s*g dd�| _d S d S )NrM rS rT r, rJ )rK � _unpickle�hasattr�setattrr" rT )r' r` r^ r r! ra � s
�
�zDataSourceOracle._unpicklec C s t | j�dg ��S )Nr2 )r$ rT r; r& r r r! �_has_network_config� � z$DataSourceOracle._has_network_configc C s t � S )z@Check platform environment to report if this datasource may run.)�_is_platform_viabler r r r! � ds_detect� s zDataSourceOracle.ds_detectc C sd t � | _tjddd�td�dtjddd�itjddd�td�dtjddd�if}| jr;t�� }t j
| j |dd|d�}nt �
� }| �� }| j�d td �}|� t|pT|| j| jttgd
�}W d � n1 shw Y |sqd S t|jd �| _|j }| _|j| _|d
|d d|d |d d�| _ d|v r�|d �d�}|r�t � |�| _ |d �d�| j d< dS )Nr- �instance�r �path)�url�headersrk r, T)�distro� interface�ipv6�ipv4�connectivity_urls_datar ��fetch_vnics_data�max_wait�timeout�metadata_patternsF�rk � ociAdName�idr �hostname� displayName)zavailability-zonez instance-idz launch-indexzlocal-hostnamer8 �metadata� user_data�ssh_authorized_keys� public_keys) �_read_system_uuid� system_uuid�IPV4_METADATA_PATTERN�format�
V2_HEADERS�IPV6_METADATA_PATTERN�perform_dhcp_setupr
�find_fallback_nicr �EphemeralIPNetworkrm r � nullcontext�_is_iscsi_rootrR r; rQ �read_opc_metadatarW rY � _get_versioned_metadata_base_urlr �metadata_addressr �_crawled_metadatar rM r| �base64� b64decode� userdata_raw) r' rq �nic_name�network_context�fetch_primary_nic�fetch_secondary_nics�fetched_metadata�datar} r r r! � _get_data� s� ����������
��� � � �
�zDataSourceOracle._get_datac C s t �| j�S )z�quickly check (local only) if self.instance_id is still valid
On Oracle, the dmi-provided system uuid differs from the instance-id
but has the same life-span.)r � instance_id_matches_system_uuidr� )r' rZ r r r! �check_instance_id s z"DataSourceOracle.check_instance_idc C s t �| j�d��S )Nr )r �normalize_pubkey_datar| r; r& r r r! �get_public_ssh_keys re z$DataSourceOracle.get_public_ssh_keysc C �
| j �� S )z)Return whether we are on a iscsi machine.)rS r( r& r r r! r� r) z DataSourceOracle._is_iscsi_rootc C r� �N)rS �
render_configr& r r r! �_get_iscsi_config s
z"DataSourceOracle._get_iscsi_configc C s� | � � r| jS d}| �� r | �� | _t�d� d| jd d d< | � � s+t�d� d}| j�dt d �}|s8|rOz| �
|� W n t yN t �
td � Y nw t| j� | jS )
z�Network config is read from initramfs provided files
Priority for primary network_config selection:
- iscsi
- imds
If none is present, then we fall back to fallback configuration.
Fz=Instance is using iSCSI root, setting primary NIC as criticalTr2 r �keep_configurationzLCould not obtain network configuration from initramfs. Falling back to IMDS.r z+Failed to parse IMDS network configuration!)rd rT r� r� �loggingr: r9 rR r; rQ �!_add_network_config_from_opc_imds� Exceptionr �logexcrC )r' � set_primary�
set_secondaryr r r! r+ s:
��� ��
z DataSourceOracle.network_configFr� c
C s~ | j du r t�d� dS |s d| j d v r t�d� dS t� }|r$| j n| j dd� }t|�D ]�\}}|o8|dk}|d �� }|�dd �oK|�d
d � }||vrWt�d |� q/|| } |rgt�|d d �}
nt�|d
�}
|r~|rxddig} n4ddig} n.g } |�d
�r�| � d|d
� d|
j
� �d�� |�d �r�| � d|d d � d|
j
� �d�� | d|t | d�} | j d � | � q/dS )a� Generate primary and/or secondary NIC config from IMDS and merge it.
It will mutate the network config to include the secondary VNICs.
:param set_primary: If True set primary interface.
:raises:
Exceptions are not handled within this function. Likely
exceptions are KeyError/IndexError
(if the IMDS returns valid JSON with unexpected contents).
Nz#NIC data is UNSET but should not be�nicIndexr z\VNIC metadata indicates this is a bare metal machine; skipping secondary VNIC configuration.r, �macAddr�ipv6VirtualRouterIpF� privateIpz)Interface with MAC %s not found; skipping�
ipv6Addresses�subnetCidrBlockr. �dhcp6�dhcp�static�/)r. �addressr3 )r8 r. r4 �mtu�subnetsr2 )
rM r9 �warningr � enumerate�lowerr; � ipaddress�
ip_network�append� prefixlen�MTUrT )
r' r� �interfaces_by_macr �index� vnic_dict�
is_primaryr4 � is_ipv6_onlyr8 �networkr� �interface_configr r r! r� N sv
� � ��
�
���
���
��z2DataSourceOracle._add_network_config_from_opc_imds)F)"r r r rP r� r �NetworkConfigSource�CMD_LINE�
SYSTEM_CFG�DS� INITRAMFSrF r r r� rW rY rL r ra r$ rd � staticmethodrg r� r� r� r� �dictr� �propertyr+ r� �
__classcell__r r r^ r! rD { s0
�
V
3rD c @ s e Zd ZdZdS )�DataSourceOracleNetFN)r r r r� r r r r! r� � s r� r� c C s | sdS | � t�d�d �S )NF�opcr )�
startswith�IPV4_METADATA_ROOT�split)r� r r r! �_is_ipv4_metadata_url� s r� c C s t �d�} | d u r d S | �� S )Nz system-uuid)r �
read_dmi_datar� )�sys_uuidr r r! r� � s
r� c C s t �d�} | tkS )Nzchassis-asset-tag)r r� �CHASSIS_ASSET_TAG)� asset_tagr r r! rf � s
rf rk c C s d| v rdS dS )Nz/opc/v2/r- r, r rw r r r! � _url_version� s r� c C s t | �dkrtS d S )Nr- )r� r� rw r r r! � _headers_cb� s r� c C sH | s| S d| v r| � d�d d S d| v r | � d�d d S td| ��)zQ
Remove everything following the version number in the metadata address.
�v2r zv2/�v1zv1/zInvalid metadata address: )r� �
ValueErrorrw r r r! r� � s r� rr rs rv c
s� � fdd�dD �}t �d|� t�� }t|||tddd�\}}|s,t �dd �|�� d
S t �d |� t� |�
d ��}t |�} d
}
| rot|� d
d�g|t�� | |tddd�\} } | rjt� | �
d ��}
t �d| � nt �d� t
| ||
|�S )a�
Fetch metadata from the /opc/ routes from the IMDS.
Returns:
Optional[ReadOpcMetadataResponse]: If fetching metadata fails, None.
If fetching metadata succeeds, a namedtuple containing:
- The metadata version as an integer
- The JSON-decoded value of the instance data from the IMDS
- The JSON-decoded value of the vnics data from the IMDS if
`fetch_vnics_data` is True, else None. Alternatively,
None if fetching metadata failed
- The url that was used to fetch the metadata.
This allows for later determining if v1 or v2 endppoint was
used and whether the IMDS was reached via IPv4 or IPv6.
c s$ g | ]}� D ] }|j |d d��qqS )rh ri )r� )r/ r �metadata_pattern�rv r r! r1 � s � ��z%read_opc_metadata.<locals>.<listcomp>)r- r, z*Attempting to fetch IMDS metadata from: %sg�������?T)�urlsrt ru �
headers_cb�
sleep_time�connect_synchronouslyz-Failed to fetch IMDS metadata from any of: %sz, Nz7Successfully fetched instance metadata from IMDS at: %szutf-8rh �vnicsz4Successfully fetched vnics metadata from IMDS at: %sz+Failed to fetch IMDS network configuration!)r9 r: �time� monotonicr r� r� �join�json�loads�decoder� �replacer )
rs rt ru rv r� �
start_time�url_that_worked�instance_responser �metadata_versionr � vnics_url�vnics_responser r� r! r� � s`
�
���
��
�r� c C s t �| t�S r� )r �list_from_depends� datasources)�dependsr r r! �get_datasource_list5 s r� �__main__z�
Query Oracle Cloud metadata and emit a JSON object with two keys:
`read_opc_metadata` and `_is_platform_viable`. The values of each are
the return values of the corresponding functions defined in
DataSourceOracle.py.r� )r� rf )Ar* r� r� r� r� r� �typingr r r r r r � cloudinitr r r
r r � cloudinit.distros.networkingr
�
cloudinit.netr r r r �cloudinit.url_helperr � getLoggerr r9 rQ r� r� �IPV6_METADATA_ROOTr� r� r� r� r �KlibcNetworkConfigSourcer" rC �
DataSourcerD r� r r� r� r$ rf r r� r� r� rW rY r� �DEP_FILESYSTEM� DEP_NETWORKr� r� � description�print�
json_dumpsr r r r! �<module> s�
� 4 1 ���
�
U���
�����